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Housekeeping 
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Housekeeping 


e Pronouns: he/him 

e The usual disclaimers 

e License: CC BY-SA 4.0 

e Kind things: @FunnelFiasco 
e Unkind things: /dev/null 

e Questions at the end 
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Shameless plug 


Program Management 
for Open Source 
Projects 


How to Guide Your Community-Driven, 
Open Source Project 


> 30% off e-book with 
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Edited by Michael Su 
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Agenda 


e Why have a bug tracker? 
e What to track 


e Picking a tracker 


Triaging bugs 
e Closing bugs 


Analyzing bugs 
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Why have a bug tracker? 
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Why have a bug tracker? 


To track bugs, silly! 
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Why have a bug tracker? 


Bug trackers are the 
cornerstone of building 
an open source community 
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Why have a bug tracker? 


e Communicate with users 
e Coordinate with contributors 
e Maintain a historical record 


e Build a source of information about the project 
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@FunnelFiasco 
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* Type (e.g. “bug” or “RFE”) 


e Status/state 
e Closure type 
* Impact 


e Priority 
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e Version 


e Component (if applicable) 


e Platform (OS and architecture) 
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e Time (-stamps) 


* Reporter 
e Assignee 


e more? 
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e Track these as separate fields, not bug content 


° If you're lucky, the tracker provides this already 
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Picking a tracker 
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Picking a tracker 


e Authentication & accounts 

¢ API libraries 

e FOSS status 

e Hosting 

e Comment/attachment hiding 


e Moderate accounts 
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Picking a tracker 


Customizable fields 

Metadata ACLs 

Links to version control, other bugs 
Bulk updates 

Milestones/epics 

Reporting 


Private bugs/comments 
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Picking a tracker 


° Default assignees 
e Multiple assignees 
e Mentioning 

e Watching 

e Subscribing 

e Locking bugs 
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Picking a tracker 


Whatever you pick, 
you'll use it as more than a bug tracker. 
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Triaging bugs 
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Triage questions (first pass) 


e Is this a bug? 

e Is it a duplicate? 

e Is it a security bug? 

e Is it filed in the right place? 
e Is it reproducible? 


* Does it say what happened? 


@FunnelFiasco CC BY-SA 4.0 


Triage questions (prioritizing) 


e Can physical harm result? 

e Does it cause data loss or corruption? 
e Does it permit unauthorized access? 
e Does it reduce accessibility? 

e Is the default configuration affected? 
e Is there a reasonable workaround? 

e Does the bug affect all platforms? 


e Does it embarrass you? 
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Closing bugs 
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Closing bugs 


You totally should! 
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To close or not to close 


° Sends a clear signal of * Makes people angry 
Intent e “I was going to work on 
e Makes the tracker easier to that someday” 
scan 


e Represents a catalog of 
known* issues 
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When to close a bug 


e When it's fixed 

e If it’s a duplicate, invalid, or spam 

¢ If the version reaches end of life 

° If you know you can't or won't fix it 
¢ If it’s missing information 


° If you can't reproduce it 
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How to close a bug 


e Set and communicate a policy ahead of time 
e Explain why 
e Give instructions to reopen 


e Ignore the complaints 
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Bug closure process 


e Varies by closure type 


° Don't be too aggressive with “missing info” and "can't 
reproduce” closures 


e Tell people how to reopen 
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Analyze bugs 
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Learn about your user community 


e Easier than a well-constructed survey 


e Learn the approximate 


- Usage by platform 
- Use of components 


- Adoption rate of new versions 
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Learn project trends 


* Bugs over time 
e Time to resolution 


e Bug severity 
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What you can't learn! 


e Time-to-response 
* Best (or worst) bug fixers 
e Affiliations 
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Challenge your own assumptions 


Bug severity 


unspecified 


urgent 


Severity 


medium 
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How to analyze 


* Look for trends that will cause a change in behavior 
e Ignore duplicates (usually) and spam (always) 


j Percentages versus raw numbers 
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Fedora Linux bugs 


e “Exploring our bugs” at Nest With Fedora 2022 
- https://youtu.be/mp1PKsQrpCM 
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Let’s talk about it 
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